home *** CD-ROM | disk | FTP | other *** search
/ Visual Basic Source Code / Visual Basic Source Code.iso / vbsource / srdemo / srdemo.txt < prev    next >
Encoding:
Text File  |  1995-08-26  |  11.5 KB  |  361 lines
  1.  
  2.  
  3.  
  4.  
  5.                                   SRDEMO 1.1
  6.                     LIB DEMO: Alphanumeric Filename Sorting
  7.                    Copyright (c) 1995 by David M. Wincelberg
  8.  
  9.  
  10.                                Table of Contents
  11.  
  12.        I.    Introduction ...........................................  1
  13.        II.   How to Use .............................................  2
  14.  
  15.        Appendices:
  16.  
  17.        A.    Command Line Parameters and Switches ...................  2
  18.        B.    Other FileJockey Software Products .....................  3
  19.        C.    License Agreement ......................................  5
  20.  
  21.  
  22.        I.    Introduction
  23.  
  24.        Thank you for trying SRDEMO.  It demonstrates library routines
  25.        (SRLIB) to sort long or short file names that may contain digits,
  26.        spaces, lower-case letters and/or commas within numbers.  For
  27.        example, SRLIB places FILE_2 before FILE_10.  It is compiled for
  28.        Microsoft C 6.0, C 7.0, VC++ 1.x and Borland TC++ 4.5 for the
  29.        small and large memory models.
  30.  
  31.             To assist you in testing SRLIB, included in SRDEMO.ZIP are
  32.        list files LISTFILE and LISTFILE.W95.  The latter file contains
  33.        long file names with embedded spaces and commas to simulate
  34.        Windows 95 long file names.  SRDEMO can read these files and sort
  35.        the names in them in addition to or instead of reading file names
  36.        from a directory.  Alternatively, you could use ZOPEN and ZDEL to
  37.        create and delete zero-size files.  ZOPEN can create files from
  38.        listfiles containing file names that do not exceed the short
  39.        ("8.3") DOS limit.
  40.  
  41.             SRDEMO is not limited to sorting a preset number of files.
  42.        In addition, it does not read the selected directory twice --
  43.        once to count the number of files and once to store them in
  44.        array.  Instead, it uses a fast approach which is documented in
  45.        SRLIB.TXT.  Its source code is included in SRLIB.ZIP.
  46.  
  47.             If you decide to license SRLIB, you can either GO SWREG
  48.        (#5947) on CompuServe or use the included order form.  A site-
  49.        license/source-code option is also on the order form.  SRDEMO is
  50.        a free program that is safe to run on a Pentium processor since
  51.        it does not perform any floating point divisions of large
  52.        numbers.  It requires DOS 2.1 or higher.
  53.             
  54.             Please send comments, suggestions and problem reports to me
  55.        at 71573,1023 by CompuServe e-mail, at 71573.1023@compuserve.com
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.        by Internet e-mail, or at my postal address, even if you are not
  66.        currently a customer.
  67.  
  68.  
  69.        II.   How to Use
  70.  
  71.        Enter
  72.  
  73.                             SRDEMO @LISTFILE /W4 /I
  74.  
  75.        to produce the listing in README.TXT.  Then enter
  76.  
  77.                        SRDEMO @LISTFILE.W95 /W4 /I /C /A
  78.  
  79.        to sort a set of long file names without regard to case, commas
  80.        or spaces.  The switch /W4 produces a wide display of no more
  81.        than four file names per line, /I selects ignoring case, /C picks
  82.        ignoring commas and /A chooses ignoring spaces.  See Appendix A
  83.        for a complete list of the command-line switches.  To create
  84.        another list file, use a text editor to place one file name at
  85.        the beginning of each line.  Don't worry about blank lines.
  86.        SRDEMO ignores them.
  87.  
  88.             Alternatively, you may use ZOPEN and ZDEL to create and
  89.        delete zero-size files with short names.  SRDEMO can sort a
  90.        mixture of names read from directories and list files.
  91.  
  92.  
  93.        Appendices
  94.  
  95.        A.    Command Line Parameters and Switches
  96.  
  97.        A.1.  SRDEMO: Demonstrates Alphanumeric Filename Sorting
  98.  
  99.        Entering
  100.                                    SRDEMO /?
  101.  
  102.        produces the following summary of command line parameters and
  103.        switches:
  104.  
  105.        SRDEMO [switches] [pattern ...] [@listfile ...]
  106.  
  107.        pattern        Filename pattern (default is *.* if no listfile)
  108.        listfile       File containing names to simulate
  109.        /I             Use case-insensitive comparisons
  110.        /A             Ignore all spaces (outside of numbers)
  111.        /M             Ignore multiple spaces (outside of numbers)
  112.        /C             Ignore commas in numbers
  113.        /P             Pause after each screen of information
  114.        /W             Use wide display -- 5 names per line
  115.        /W4            Use wide display -- 4 names per line
  116.  
  117.  
  118.  
  119.                                     Page 2
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.        The names in a listfile can be up to 78 characters long.  The /W4
  127.        switch produces a display that can be included in a memo without
  128.        re-formatting.
  129.  
  130.  
  131.        A.2.  ZOPEN: Creates a single or set of zero-size files
  132.  
  133.        Entering
  134.                                    ZOPEN /?
  135.  
  136.        produces the following summary of command line parameters:
  137.  
  138.        ZOPEN { filename | @listfile }
  139.  
  140.        filename       A single file name
  141.        listfile       Name of a file containing a list of files to
  142.                       create, one file name per line
  143.  
  144.        The braces and vertical bar (|) mean that you must choose to
  145.        create either a single short file name or tell the program where
  146.        to find a list of short file names.  Note that you must precede
  147.        the list-file name with the at-sign (@).
  148.  
  149.  
  150.        A.3.  ZDEL: Deletes zero-size files
  151.  
  152.        Entering
  153.                                     ZDEL /?
  154.  
  155.        produces the following summary of command line parameters:
  156.  
  157.        ZDEL [drive:][directory]pattern
  158.  
  159.        pattern        A file name or a wildcard pattern
  160.  
  161.        This parameter is self-explanatory.
  162.  
  163.  
  164.        B.    Other FileJockey Software Products
  165.  
  166.        Following is a list of current FileJockey Software products.  All
  167.        of the compressed files for these products have extension ZIP.
  168.        In parentheses after the descriptions are the locations where the
  169.        programs may be found on CompuServe and the registration/license
  170.        fees.
  171.  
  172.  
  173.        B.1.  System Tools
  174.  
  175.        WRDGRB 1.1 -- Copies Words From DOS Screen to Command Line:
  176.  
  177.  
  178.  
  179.                                     Page 3
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.        No more typing words you see on the DOS screen!  With WRDGRB
  187.        installed, you simply press the hot-key sequence, highlight text
  188.        with your mouse, and left click to copy it to the command line
  189.        (or right click to cancel).  WRDGRB even connects a filename to
  190.        its extension when both are highlighted in a directory listing.
  191.        New: smaller by 19K, a default-values file, and more.  23K TSR.
  192.        No known bugs.  GO SWREG (#5571) to register on-line.  (GO
  193.        PCUTIL, Library 3, $35)
  194.  
  195.  
  196.        LISTRS 1.2 -- Directory/Program List Makers With Action Options:
  197.  
  198.        DIRLIST: More accurate than "dir *."  Options include show files,
  199.        change to and remove directory.  PROGLIST: Shows current
  200.        directory's .EXE, .COM and .BAT files in one listing to help
  201.        users find the name of the program file to run.  Options include
  202.        type & run, type & wait and edit .BAT files with a user-selected
  203.        editor.  Both programs correctly sort numbers within filenames.
  204.        No known bugs.  (GO PCUTIL, Library 5, $15)
  205.  
  206.  
  207.        B.2.  Programmer Tool
  208.  
  209.        PROGCR 1.0 -- Prepares Programs for Copyrighting:
  210.  
  211.        Protects the privacy of your C/C++ or PASCAL source code
  212.        copyright deposit by removing comments after each file's header
  213.        (which should primarily consist of your copyright notice) from
  214.        copies of the original files.  Also, copies words displayed by
  215.        standard or user-specified print commands to a file for spell
  216.        checking.  (GO PCPROG, Library 6, $10)
  217.  
  218.  
  219.        B.3.  BBS-Session Tools
  220.  
  221.        CFWRAP 1.1 -- Word Wrapping Tuned for BBS Capture Files:
  222.  
  223.        Prepares BBS capture files for editing by removing page pause
  224.        lines ("Press <CR> for more !", etc.) and word-wrapping various
  225.        types of paragraphs (including each line starting with ">>" and
  226.        indented paragraphs).  Many page pause lines are in a user-
  227.        changeable .INI file.  Version 1.1 improvements include multi-BBS
  228.        support and better word wrapping.  (GO PCCOM, Library 2, $15)
  229.  
  230.  
  231.        FRMDSK 1.0 -- Enters Text From Disk With Line Preview & Edit:
  232.  
  233.        Use FRMDSK when a BBS requires you to type in lines instead of
  234.        allowing you to upload a file.  It copies lines from a file to
  235.        your BBS software (or other program) after giving you options.
  236.  
  237.  
  238.  
  239.                                     Page 4
  240.  
  241.  
  242.  
  243.  
  244.  
  245.        These options include edit line, finish file, wait, cancel,
  246.        next/previous line and another file.  Works only with DOS text
  247.        programs that read the keyboard in the standard way.  66K TSR.
  248.        (GO PCCOM, Library 2, $15)
  249.  
  250.  
  251.        C.    License Agreement
  252.  
  253.        This is a legal agreement between you ("Licensee") and FileJockey
  254.        Software ("Licensor").  Licensor owns all worldwide rights,
  255.        title, copyright and other interests in and to the computer
  256.        program identified as SRDEMO 1.1 ("Software").  By using the
  257.        Software, you are agreeing to be bound by the following terms:
  258.  
  259.        1.   Licensor grants to Licensee the non-exclusive and non-
  260.        assignable right to use the Software without paying a fee to
  261.        Licensor.
  262.  
  263.        2.   Licensee may distribute copies of the Software and related
  264.        files to others provided Licensee informs the recipients that the
  265.        Software is subject to a license agreement.  The attached
  266.        VENDINFO data record is hereby incorporated by reference.  Any
  267.        distribution satisfying all the distribution requirements
  268.        expressed in that data record is hereby authorized.
  269.  
  270.        3.   Licensor hereby alerts Licensee that the Software and
  271.        accompanying documentation are provided "AS IS" without warranty
  272.        of any kind.  Licensee assumes all risks involving use of the
  273.        Software and its results and performance.
  274.  
  275.        4.   Licensee hereby acknowledges that Licensor bears no
  276.        responsibility or liability which may arise or result from
  277.        Licensee's use of the Software.  Licensee hereby waives and
  278.        releases Licensor from any and all claims for damages, losses and
  279.        costs therefrom.  In no event shall Licensor's liability for any
  280.        damages ever exceed the price paid for license and registration,
  281.        regardless of the form of the claim.
  282.  
  283.        5.   This license agreement shall be construed and enforced in
  284.        accordance with the laws of the State of California.  This
  285.        agreement may not be modified except by written instrument signed
  286.        by both parties.  If any provisions of this agreement are found
  287.        to be invalid or unenforceable by the operation of the law, then
  288.        invalidity or unenforceability of such provision(s) shall not
  289.        affect the validity or enforceability of the other provisions of
  290.        this agreement.  Any dispute arising from this agreement shall be
  291.        submitted to California courts located in Los Angeles County, and
  292.        Licensee hereby submits to the jurisdiction of such courts.
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.                                     Page 5
  300.  
  301.  
  302.  
  303.  
  304.  
  305.        All (registered) trademarks and (registered) service marks are
  306.        properties of their respective companies.
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.                                     Page 6
  360.  
  361.